BBDOS IS A FULLY AUTOMATIC,BASIC 
TRANSPARENT OPERATING SYSTEM FOR 
AERCO DISK USERS ON ZX81/TS51000. 


THE ONLY REQUIREMENT 15 THAT RAM 
MUST BE ENABLED АТ 2000-2FFF HEX 
(8-12K)AND 3800-3FFF HEX(14-16K) 
IN ADDITION TO NORMAL BASIC RAM. 


RAND USR 13303 TO LOAD. WHEN THE 
DISK STOPS IT TAKES A MOMENT FOR 
BBDOS TO INITIALIZE THE SYSTEM. 

"DISK ERROR" MAY MEAN YOUR 8-16K 
RAM IS NOT WORKING AS IT SHOULD. 


IF THE DIRECTORY APPEARS,TYPE IN 
"HELP1"(ENTER) AND YOU WILL LOAD 
THE BBDOS DOCUMENTATION PROGRAM. 


— BBDOS FEATURES AND FUNCTIONS — 


COMPLETELY INDEPENDENT OF BASIC. 
RESET OR "NEW" LEAVES IT INTACT. 


FREES USER FROM DISK MANAGEMENT. 
EVERYTHING MANAGED BY FILE NAME. 
HANDLES 16/64K PAGE INTERMIXING. 
EASY CONVERSION FROM SADOS DISK. 
SINGLE FILE AND FULL DISK MOVES. 


HOT-Z SAVE/LOAD WITH DISK FILES. 
"Z-TODLS" OR YOUR PROGRAM 8-10K. 


OPTIONAL NAMED PROGRAM AUTOLOAD. 


SUPPORTS 1 OR 2 DRIVES,SS OR DS. 
SUPPORTS ALL PRINTER INTERFACES. 


BASIC CAN INITIATE 45 FUNCTIONS. 


-"ВВОО5" DISK OPERATING SYSTEM ~ 


PAGE 1 CONTAINS THE DOS CODE AND 
DIRECTORY.UPON LOADING THIS PAGE 
THE FOLLOWING STEPS TAKE PLACE ~ 


1)MOVE ALL CODE TO 8-16K AREA 
2) SUMCHECK TEST FOR CORRUPTION 
S)GIVE"DISK ERROR"IF INCORRECT 
4)SET RAMTOP TO 64K, DO A "NEW" 
S)LOAD DISK DIRECTORY TO RAM 
&6A5 LOAD AUTOLOAD/HOT-Z11 OVERLAY 
7)SUMCHECK TEST THIS OVERLAY 
8)GIVE"DISK ERROR"IF INCORRECT 
9) TEST FOR OPTIONAL AUTOLOAD 
10)1F SO,LOAD PROGRAM, OTHERWISE: 
11)ENTER DOS, DISPLAY DIRECTORY. 


- BBDOS DIRECTORY MANAGEMENT - 


BBDOS RETAINS THE AERCO METHODS 

OF 16K AND 644K PAGES AND THUS IS 
COMPATIBLE WITH THE OLD RAND USR 
CALLS. IN ORDER TO MAXIMIZE USE, 
A CLEAR DIRECTORY HAS PAGES 2,3, 
10,AND 20 FLAGGED AS 16K USE, AND 
PAGES 4-5-6,7-8-9,11-12-13,14-15 
-16,17-18-19 AS 5 64K USE PAGES. 


SINGLE SIDE VERSION IS 2,3,10 AS 
16K; 4-5-6,7-8-9 AS 2 64K PAGES. 


A 16K PAGE ACTUALLY CAN HOLD 20K 
OF DATA. BBDOS CALCULATES. ACTUAL 
NEEDS. IT HAS DIRECTORY FLAGS FOR 
16/64,FREE/IN USE,PROG/VARS USE. 
IT DECONFIGURES 64K PAGES TO 16K 
PAGES WHEN NEEDED, RECONFIGURES 

IF THE 3 16k PAGES BECOME FREE. 


= BBDOS VERSION DIFFERENCES - 


YOUR BBDOS IS CUSTOMIZED FOR THE 
DISK TYPE AND PRINTER INTERFACE 

YOU HAVE SPECIFIED. AN ID CAN BE 
FOUND IN 3FFO-3FFC AFTER LOADING 
OR IN LINE 4 IF YOU "BREAK"LOAD. 


ALL VERSIONS SUPPORT 2 DRIVES, IF 
YOU HAVE ONLY 1 SIMPLY AVOID THE 
COMMANDS THAT ACTIVATE DRIVE B. 
DIRECTORY CAPACITY IS MATCHED TO 
THE DISK DRIVE TYPE CAPABILITY. 


ALL PRINTER I/F VERSIONS OPERATE 
THE SAME EXCEPT FOR MEMOTECH AND 
TIMEX 2040. DOS COMMANDS OPERATE 
NORMALLY FOR THESE TWO, BUT FROM 
BASIC USE YOUR OLD METHODS. ONLY 
THE 24 LINE COPY(Z=12)FUNCTIONS. 


= BBDOS PRINTER SUPPORT = 


CREDIT GDES TO FRED NACHBAUR FOR 
THE PRINTER INTERFACE DRIVER IN 

BBDOS 3.5. EXCEPT FOR TIMEX 2040 
AND MEMOTECH, 2800-29FF CONTAINS 
А SLIGHTLY MODIFIED COPY OF"UPD" 
AS PER SYNCWARE NEWS.,VOL.Z2,ND.6. 
(MEMOTECH HAS A COPY OF I/F ROM) 


— CONVERSION TO BBDOS DISK - 


1)LOAD BBDOS; "STOP" TO BASIC. 
2)LOAD BASIC RAM WITH OLD METHOD 
3)RETURN TO BASIC IMMEDIATE MODE 
4) INSERT A BBDOS DISK. 

S)RAND USR 11000 TO ENTER BBDOS. 
6) USE :W COMMAND TO SAVE PROGRAM 


NOTE WHILE IN BASIC YOU MAY LOAD 
ANYTHING EXCEPT 8-16K, EVEN RAND 
USR 13303 TO USE SADOS TO LOAD. 


— BBDOS KEYBOARD INPUT ~ 
THE INPUT PROMPT FOR BBDOS IS > 
ON LINE 24. 1T ACCEPTS A MAXIMUM 
OF 30 CHARACTERS-DIGITS,LETTERS, 
AND SYMBOLS IN NORMAL MODE ONLY. 
THE "DELETE" KEY(SHIFT 0) WORKS. 
LOADING ANY PROGRAM ON THE DISK 
IS DONE BY TYPING THE DIRECTORY 
NAME OR PARTIAL NAME. IF PARTIAL 
IT WILL LOAD THE FIRST MATCH. 


ALL COMMANDS ARE OF THE FORM :x 
WHERE x IS ONE LETTER OR DIGIT. 


ALL INPUT IN BBDOS EXCEPT "STOP" 
15 TERMINATED VIA "ENTER" KEY. 


PRESSING "STOP" (SHIFT A) AT ANY 


TIME DURING INPUT WILL EXIT DOS 
AND ENTER THE BASIC (LIST) MODE. 


- BBDOS COMMAND SUMMARY — 
:Q QUIT :R REBOOT SYSTEM 
zW WRITE PROG. :E ERASE ENTRY 
E PRINT DIREC. :L LLIST BASIC 
zF FORMAT DISK М NUMBER DISK 


zX SWITCH DRIVE :C COPY DISK 


:М MOVE :S SINGLE MOVE 
¿H-HOT-=Z II :Z Z-TOOLS 
:J AUTOLOAD :А BOLD OFF 
:B BOLD ON :0,1,8,9 SIZE 


"STOP" ENTERS BASIC (LIST) MODE, 
ENTER BBDOS WITH RAND USR 11000. 


- BBDOS COMMAND DESCRIPTIONS ~ 


:Q (DUIT) ABORTS ANY COMMAND AND 
RETURNS TO THE MAIN SCREEN. USED 
TO ESCAPE BEFORE WRITING TO DISK 
ТЕ YOU DECIDE NOT TO CONTINUE. 


THIS OPTION IS AVAILABLE AT ANY 
OF THE INPUTS REQUESTED BY THE 
¿N,:E,:F,:N,2C,21M,:1S,:3J COMMANDS 


*NOTEX* IF YOU ARE ALREADY AT THE 
MAIN SCREEN, :Q RETURNS TO THE 
ROUTINE WHICH CALLED IN THE DOS. 
NORMALLY THIS RETURNS TO BASIC. 


sR (REBOOT) SAME AS INITIAL BOOT 
BUT STAYS ON CURRENT DRIVE(A/B). 
USED TO COMPLETELY CLEAR SYSTEM. 


~ BBDOS COMMAND DESCRIPTIONS - 


ТЫ (WRITE PROGRAM) DETERMINES IF 
16K OR 64K SPACE REQUIRED BY THE 
RESIDENT BASIC PROGRAM. ASSIGNS 
PROPER SIZE DIRECTORY ENTRY. IF 

REQUIRED, DECONFIGURES THE FIRST 
FREE 64k SLOT INTO 3-16K. INFORMS 
USER WHEN NO SPACE IS AVAILABLE. 


ASKS FOR NAME TO BE SHOWN IN THE 
DIRECTORY. TRUNCATES IF OVER 15. 


ASKS FOR AUTOSTART LINE NUMBER. 
IF NONEXISTANT FINDS NEXT HIGHER 
LINE NUMBER. IF NO HIGHER NUMBER 
EXISTS THE PROGRAM IS WRITTEN AS 
NON-AUTOSTART. IF NO ENTRY, THEN 
DEFAULTS TO 1ST LINE AUTOSTART. 


PROGRAM WILL ВЕ "FAST"MODE,CLEAR 
SCREEN,WITH SELECTED START LINE. 


— BBDOS COMMAND DESCRIPTIONS ~ 


¡E (ERASE ENTRY) DELETES THE 1ST 
DIRECTORY ENTRY MATCHING INPUT. 
REQUIRES THE FULL NAME. ЇР ALL 3 
16K ENTRIES NOW BECOME FREE IN A 
PREVIOUSLY DECONFIGURED 64K SLOT 
IT IS RECONFIGURED TO 64k FREE. 


:P (PRINT DIRECTORY) GIVES YOU A 
HARD COPY OF THE DIRECTORY. 


zL (LLIST BASIC) LISTS ANY BASIC 
PROGRAM RESIDENT, FROM THE FIRST 
LINE THAT BASIC CURRENTLY HOLDS 
FOR LISTING (WITH THE > CURSOR), 
TO THE LAST LINE OF THE PROGRAM. 


. THEREFORE YOU CONTROL THE START 


LINE BY THE LAST"LIST"ON SCREEN. 


- BBDOS COMMAND DESCRIPTIONS ~ 


¿F (FORMAT DISK) LOADS BBDOS TO 
BASIC AREA. ASKS FOR DRIVE TO BE 
USED. ASKS FOR NEW DISK NUMBER. 
FORMATS DISK,THEN WRITES DOS AND 
CLEAR DIRECTORY ON THE NEW DISK. 


¿N (NUMBER DISK) CHANGES A DISK 
NUMBER BUT PRESERVES ALL ELSE. 


¿X (SWITCH DRIVE) TOGGLES BBDOS 
BETWEEN DRIVES A AND B. COMMANDS 
NOW APPLY TO THE NEW DRIVE. 


:С (COPY DISK) COPIES THE ENTIRE 
DISK FROM DRIVE В TO DRIVE A. IT 
REQUIRES A FORMATTED DISK IN A. 


- BBDOS COMMAND DESCRIPTIONS ~ 


:М (MOVE) COPIES ANY 1 ENTRY ІМ 
THE CURRENT DRIVE DIRECTORY TO 
THE OTHER DRIVE. REQUIRES THE 
FULL NAME. DOES THE MOVE WITHOUT 
STOPPING. INFORMS USER IF NO FREE 
SPACE ON DESTINATION DISK.FDRCES 
A REBOOT WHEN DONE SINCE 1T USES 
THE BASIC AREA IN AN ODD MANNER. 
NO SIZE RESTRICTIONS ON :M MOVE. 


sS (SINGLE MOVE) SIMILAR TO A :M 
MOVE BUT ACCOMPLISHES IT USING A 
SINGLE DRIVE. PROMPTS USER WHEN 

TO INSERT THE DESTINATION DISK. 

A RESTRICTION IS ANY 64K PROGRAM 
plus VARIABLES WITH E-LINE ABOVE 
64520 (LONG ENOUGH TO BE WITHIN 

500 BYTES OF AERCO MAXIMUM SIZE) 
EXCEEDS THE LIMIT OF THE COPY. 


— BBDOS COMMAND DESCRIPTIONS — 


zH (HOT-Z II) JUMPS TO HIGH RAM 
VERSION ONLY IF FOUND LOADED AT 
9800H. SEE APPENDIX FOR CHANGES 
TO НОТ-2 II FOR BBDOS OPERATION. 


12 (Z-TOOLS) EXECUTES Z-TOOLS IF 
IT HAS BEEN LOADED AT 2000H. SEE 
APPENDIX FOR CHANGES TOD Z-TODLS. 


:Ј (AUTOLOAD) ASKS FOR NAME THAT 


‚ WILL BE AUTOLOADED WHEN BBDOS IS 


BOOTED FROM THIS DISK. NO ENTRY 
WILL CLEAR AUTOLOAD - :Q ABORTS 
WITHOUT ANY CHANGE. PARTIAL NAME 
WORKS SAME AS MANUAL LOAD. LOADS 
BBDOS INTO BASIC, REWRITES BBDOS 
WITH SELECTED AUTOLOAD NAME, AND 
RETURNS TO THE MAIN SCREEN. 


— BBDOS COMMAND DESCRIPTIONS ~ 


sA (BOLD OFF) SENDS ESC "(1B22H) 
TO PRINTER. BOLD PRINT CLEAR ON 
PROWRITER PRINTER. 


:В (BOLD ON) SENDS ESC ! (1B21H) 
TO PRINTER. BOLD PRINT SELECT ON 
PROWRITER PRINTER. 


:0 (PROPORTIONAL) SENDS ESC P TO 
PRINTER (1B50H). PROPORTIONAL MODE 
PITCH ON PROWRITER PRINTER. 


:1 (132 COLUMN) SENDS ESC O TO 
PRINTER(1BS1H). 17 CPI PITCH ON 
PROWRITER PRINTER. 


:8 (80 COLUMN) SENDS ESC N TO 
PRINTER(1B4EH). 10 CPI PITCH ON 
PROWRITER PRINTER. 


¬ BBDOS COMMAND DESCRIPTIONS - 


:9 (96 COLUMN) SENDS ESC E TO 
PRINTER(1B45H). 12 CPI PITCH ON 
PROWRITER PRINTER. 


"STOP" CAN BE CONSIDERED AS ONE 
OF THE COMMANDS ALSO. 1T EXITS TO 
BASIC (LIST) MODE WHENEVER USED. 


BBDOS MAY BE ENTERED AT ANY TIME 
FROM BASIC WITH"RAND USR 11000". 


"RAND USR 12000" INITIATES BBDOS 
FUNCTIONS FROM BASIC - SEE PART 
TWO (HELP2)0F THESE INSTRUCTIONS. 


** BBDOS INFORMATION APPENDIX ++ 
— MEMORY MAP — 


2000-27FFH  Z-TODOLS AREA 
(POSSIBLE TO USE FOR OTHER CODE) 


2800-287FH ASCII TABLE 
2880-29FFH PRINTER SUPPORT 
2A00-2FFFH  BBDOS CODE 
3000-37FFH АЕРСО BOARD 
3800-39FFH  DIRECTORY/DISK BUF 
ЗАОО-ЗЕВЕН BBDOS CODE 
SECO-3FEFH BBDOS OVERLAY AREA 


3FFO-3FFFH  BBDOS 1D/MD2 I/F 


жє BBDOS INFORMATION APPENDIX ** 
- DIRECTORY FORMAT- 


3800-381FH DIRECTORY HEADER 
3820-39FFH 20 ENTRIES,AS BELOW: 
1 BYTE -CURRENT USE 
1 BYTE -INITIAL USE 
2 BYTES -PAGE READ CALL 
2 BYTES -CURRENT PAGE WRITE CALL 
2 BYTES -INITIAL PAGE WRITE CALL 
1 BYTE -UNUSED BYTE 
15 BYTES-NAME FOR ENTRY 
USE BYTES FORMAT: 
1=ENTRY IS IN USE 
1=PROGRAM MODE USE 
1=VARIABLES MODE USE 
=(MUST BE ONE) 
1=16k PAGE USE 

UNUSED BIT 
1=64K PAGE USE 
1=END OF DIRECTORY 


Y 
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жж BBDOS INFORMATION APPENDIX ++ 


THE BEST WAY TO SEE THE RESULTS 
OF THE ASCII TRANSLATION TABLE 
IS VIA THIS SHORT BASIC PROGRAM: 


10 FOR A=0 TO 255 

20 LET 2%= STR$ A 

50 LET Z=? 

40 RAND USR 12000 

SO LET 2%=" "+ CHR$ А 


60 LET Z=8 
70 RAND USR 12000 
80 NEXT A 


THIS WILL PRINT DECIMAL VALUE OF 
Z$ WITH THE TRANSLATED CHARACTER 
FOLLOWING IT. 


IF YOUR PRINTER DOES ODD THINGS 
ON VALUES OF 64 TO 127,ELIMINATE 
THIS RANGE OF"A"IN THE FOR/NEXT. 


жж BBDOS INFORMATION APPENDIX *x 


HOT Z-11 15 A SUPER PROGRAM FROM 
RAY KINGSLEY (SINWARE),BOX 8032, 
SANTA FE,¿,N.M.,87504. BBDOS HOPS 
IN AND OUT OF HIGH RAM HOT 7-11. 


MAKE THE FOLLOWING CHANGES TO A 
9800H VERSION OF HOT 7-11: 


9808 210097 LD HL,9700 
9С55 C3F82A JP 2АЕВ 
9D1D CDF828 CALL 28F8 
9D20 00 NOP 

9D21 00 NOP 

9D22 00 NOP 

ASFO CD1F2E CALL 2E1F 
ASF3 FS PUSH AF 
ASF4 C4F52D CALL NZ 2DFS 
ASF7 F1 POP AF 
A3F8 Co КЕТ М7 
A3F9 Срғ228 CALL 28F2 


жж BBDOS INFORMATION APPENDIX ++ 


THESE CHANGES ARE TO RAMTOP,EXIT 
(SHIFT Q ІМ READ MODE) ,AND SHIFT 
Y PRINT ROUTINES.FOR MEMOTECH OR 
2040 CHANGE ONLY THE FIRST TWO. 


BBDOS 3.5 HAS BUILT-IN ROUTINES 
THAT PROVIDE DISK LOAD AND SAVE 
FOR HOT-Z11 64K RUNNING AT 535800 
IN LOW RAM OR 9800 IN HIGH RAM. 
BBDOS HANDLES THE PROPER RETURN. 
TAPE LOAD/SAVE IS NOT DISTURBED. 


LOAD IS AT 3E90;SAVE AT 3E91. IF 
USING WRITE MODE FUNCTION-A FOR 
LOAD AND FUNCTION-B FOR SAVE,SET 
F6AO-F6AS TO "905Е9153Е" FOR BOTH 
VERSIONS. FUNCTIONING IS EXACTLY 
THE SAME AS TAPE EXCEPT NAME IS 
MANDANTORY — NO ENTRY ABORTS. 
MAXIMUM NAME IS 15 CHARACTERS. 


** BBDOS INFORMATION APPENDIX ++ 


MAXIMUM SAVE IS 1 "16K" PAGE OR 
20480 CHARACTERS. НОТ-2 WRITTEN 
FILES ARE FLAGGED AS "PROGRAMS" 
IN THE DIRECTORY SO THAT YOU CAN 
CREATE LOADABLE PROGRAMS. FILES 
MAY BE WRITTEN FROM ANY RAM AREA 
BUT THERE IS A POSSIBLE PROBLEM 
WHEN AERCO READS IN A PROGRAM — 
IF 407C IS WRONG AS THE PROGRAM 
READS IN, SIDE SELECTION CAN BE 
LOST. BBDOS HANDLES THIS FOR YOU 
IF YOU SAVE STARTING AT 8009; IT 
AUTOMATICALLY CHANGES 807B/807€ 
TO THE CORRECT AERCO PARAMETERS. 
FOR HOT-Z USE, NO RESTRICTIONS. 


THE AUTHOR HAS AVAILABLE FOR $10 
А DISK WITH LOW/HIGH VERSIONS OF 
HOT-Z11 FULLY PATCHED AND READY 
FOR BBDOS USE (MUST OWN HOT-Z11). 


жк BBDOS INFORMATION APPENDIX xx 


Z-TODLS IS ALSO SOLD BY SINWARE. 
THE EXIT AND LPRINT CHANGES ARE: 


2165 CAF82A ЈР Z 24AF8 
2168 FE77 СР77 

216А 280F JR 2 217B 
2166" E1 POP HL 
216D 77 LD (Н) „А 
216E 25 INC HL 
216F FE76 CP 76 
2171 СӨ РЕТ 2 
2172 FE64 CP 64 
2174 301€ JR NC 2192 
2176 ES PUSH HL 
2177 D7 RST 10H 
2178 18DA JR 2154 
217A OO NOP 


(BELOW NOT FOR MEMOTECH OR 2040) 
2294 CD482E CALL 2E48 


** BBDOS INFORMATION APPENDIX ** 


SINCE THE BBDOS CODE 15 SUMCHECK 
TESTED FOR CORRUPTION, YOU MUST 
ALSO CHANGE THE SUMCHECK IF YOU 
MAKE ANY CHANGES TO THE CODE. 


THE BEST WAY TO CHANGE BBDOS IS 
TO HAVE HOT Z-11 IN HIGH MEMORY, 
zF TO BRING BBDOS INTO BASIC AND 
THEN :Q TO ABORT THE COMMAND. NOW 
zH TO BRING IN HOT 7-11. 


THE LOADER IS AT 4082-40D3H IN 
THE O REM. -MAKE CHANGES TO BBDOS 
IN THE BASIC AREA, THEN EXECUTE 
THE CODE FROM 4082 TO 40B7. THE 
DE REG HAS THE NEW SUMCHECK. PUT 
IT IN THE LD HL FOUND AT 40B8. 
SHIFT Q TO BBDOS,"STOP"TO BASIC, 
RAND USR 22947 TO REWRITE BBDOS. 


жє BBDOS INFORMATION APPENDIX xx 


THE AUTHOR OF BBDOS WILL ATTEMPT 
TO ANSWER QUESTIONS OR ASSIST IN 
MAKING CODE CHANGES. WRITE TO: 


BILL BELL 
596 CHERRINGTON ROAD 
WESTERVILLE, OHIO 43081 


NEEDED INFORMATION FOR ANALYSIS: 
NUMBER OF DISK TRACKS/SIDES 


MEMORY DOCUMENTATION 
PRINTER I/F DOCUMENTATION 


PLEASE INCLUDE A SELF-ADDRESSED 
STAMPED ENVELOPE FOR THE REPLY. 


- BBDOS FUNCTIONS FROM BASIC - 


BASIC PROGRAMS CAN HOOK INTO ALL 
BBDOS FUNCTIONS SIMPLY BY SAYING 


RAND USR 12000 


THE CONTENT OF SIMPLE VARIABLE 
“Z" DETERMINES THE FUNCTION TO 
BE PERFORMED, AND THE CONTENT OF 
THE SIMPLE STRING "7%" SERVES AS 
THE NAME OR DATA TO BE HANDLED. 


BBDOS AUTOMATICALLY FINDS Z AND 
Z$ IN YOUR PROGRAM, AND RETURNS 
TO YOU ANY NEW VALUES RESULTING. 


IN MOST CASES Z RETURNS WITH THE 
VALUE OF O WHEN THE FUNCTION WAS 
PERFORMED AS EXPECTED, AND WHEN 

IT WAS NOT,Z RETURNS AS 255. YOU 
TEST Z TO DETERMINE NEXT ACTION. 


—- BBDOS FUNCTIONS FROM BASIC - 
AS АМ EXAMPLE, THE BASIC LINES 


100 LET Z=3 

110 LET 2%= "РРОБМАМЕ " 

120 RAND USR 12000 

130 IF 2=0 OR Z=3 THEN GOTO 160 
140 PRINT "NO SPACE" 

150 GOTO 170 

160 PRINT "OK" 


WILL WRITE ITSELF ON DISK, WITH 

THE LINE NUMBER 130 AS THE PLACE 
OF RESTART, THE SAME AS A PROGRAM 
"SAVE" LINE IN BASIC WOULD DO. 


THE DIRECTORY NAME IS"PROGNAME". 
Z=3 MUST BE ALLOWED FOR BECAUSE 


IF THE PROGRAM IS LOADED, Z will 
BE =3 ; IT WAS WHEN WE WROTE ІТ. 


— BBDOS FUNCTIONS FROM BASIC - 
ANOTHER EXAMPLE WOULD BE 

100 LET Z=12 

110 RAND USR 12000 

120 IF Z=0 THEN GOTO 150 

130 PRINT "PRINTER NOT DN" 

140 STOP 


HERE THE FUNCTION 1S SCREEN COPY 
TO YOUR PRINTER INTERFACE. 


EACH FUNCTION USES Z,Z$,AND RAND 
USR 12000. THE FOLLOWING TABLES 
GIVE THE SPECIFICS FOR EACH ONE. 


—- BBDOS FUNCTIONS FROM BASIC - 
FUNCTION — USE DOS "INPUT" 

2 TO DOS = O 

Z RETURN — NO CHANGE 

z$ TO DOS - NOT APPLICABLE 

Z$ RETURN – DATA INPUT BY USER 
THIS FUNCTION ALLOWS YOU TO USE 
THE BBDOS KEYBOARD INPUT ROUTINE 
FOR ANY PURPOSE. COULD REPLACE 


LONG ІМКЕҮФ ROUTINES IN BASIC. 


USES LINE 24 ON THE SCREEN, AND 
MAXIMUM INPUT LENGTH IS 30 CHAR. 


RETURNS TO BASIC IN SLOW MODE. 


—- BBDOS FUNCTIONS FROM BASIC ~ 
FUNCTION — DISPLAY DIRECTORY 
2. TO DOS = 1 
Z RETURN — МО CHANGE 
2% TO DOS - NOT APPLICABLE 
7% RETURN — NO CHANGE 
THIS FUNCTION PUTS THE DIRECTORY 
OF THE CURRENT DOS DRIVE IN THE 


DISPLAY FILE. 


IT USES LINES O TO 18 AND LEAVES 
LINE 19 AS NEXT PRINT POSITION. 


1T RETURNS IN FAST MODE. 


— BBDOS FUNCTIONS FROM BASIC - 
FUNCTION — SWITCH DISK 
2 TO DOS - 2 
Z RETURN — NO CHANGE 
2% TO DOS ~ NOT APPLICABLE 


Z$ RETURN — NO CHANGE 


THIS FUNCTION CAUSES THE DOS TO 
SWITCH TO THE OTHER DISK, SAME 
AS THE :X COMMAND IN BBDOS. 


RETURNS IN SAME SPEED MODE. 


—- BBDOS FUNCTIONS FROM BASIC - 
FUNCTION - SAVE PROGRAM WITH 
NEXT BASIC LINE 
AS RESTART LINE 
Z TO: DOS =-3 


Z RETURN – O IF WRITTEN OK 
255 IF NO DISK SPACE 


2% TO DOS - NEW DIRECTORY NAME 
(TRUNCATES OVER 15) 


Z$ RETURN — NO CHANGE 
THE "SAVED" PROGRAM WILL BE IN 
FAST MODE WITH THE DISPLAY FILE 


CLEAR AND Z=3. RETURN ALSO FAST 
MODE WITH DISPLAY FILE CLEAR. 


— BBDOS FUNCTIONS FROM BASIC - 
FUNCTION — LOAD IN NEW PROGRAM 
2 TO DOS - 4 
Z RETURN — NOT APPLICABLE 


2% TO DOS - NAME OF PROGRAM 
(TRUNCATES OVER 15) 


Z$ RETURN — NOT APPLICABLE 


EXECUTES A "NEW" (RAMTOP AND ALL 
ABOVE IT PRESERVED)3 LOADS FIRST 
PROGRAM WHOSE NAME MATCHES 7% UP 
TO THE LENGTH OF Z$, 


IF NO MATCH IS FOUND THE ROUTINE 
EXITS TO BBDOS. USING Z=11 FIRST 
WOULD ELIMINATE FALSE ATTEMPTS. 


- BBDOS FUNCTIONS FROM BASIC - 


FUNCTION – SAVE VARIABLES FILE 
(DATA MODE) 


2 TO DOS - 5 


Z RETURN — O IF WRITTEN OK 
255 IF NO DISK SPACE 


2% TO DOS — NEW DIRECTORY NAME 
(TRUNCATES OVER 15) 


Z$ RETURN — NO CHANGE 


THIS FUNCTION WILL WRITE A FILE 
IN AERCO "DATA" MODE (FROM VARS 
TO E-LINE). THE DIRECTORY FLAG 
WILL BE SET TO INDICATE VARS. 


IT RETURNS IN FAST MODE. 


—- BBDOS FUNCTIONS FROM BASIC — 


FUNCTION - LOAD VARIABLES FILE 
(DATA MODE) . 


2 TO DOS = 6 


Z RETURN – O IF READ ОК 
255 IF NOT FOUND 


2% TO DOS – DIRECTORY NAME 
(TRUNCATES OVER 15) 


Z$ RETURN — FULL NAME IF FOUND 
NO CHANGE IF FAIL 


SEARCHES DIRECTORY FOR THE FIRST 
MATCH(UP TO THE LENGTH OF 7%) OF 
VARIABLES FILES ONLY; LOADS USING 
AERCO DATA MODE (VARS TO E-LINE) 
RETURNS TO BASIC IN FAST MODE. 


лн, 


- BBDOS FUNCTIONS FROM BASIC - 
FUNCTION — ERASE DISK ENTRY 
Z TD DOS = 7 


Z RETURN - O IF ERASED OK 
255 IF NOT FOUND 


2% TO DOS - FULL NAME OF ENTRY 
(TRUNCATES OVER 15) 


Z$ RETURN — NO CHANGE 

THIS FUNCTION WILL ERASE A VARS 
OR PROGRAM WHOSE NAME MATCHES Z$ 
EXACTLY. OPERATES THE SAME AS :E 
COMMAND. IF NO MATCH THEN Z=255. 


RETURNS TO BASIC IN FAST MODE. 


- BBDOS FUNCTIONS FROM BASIC - 
FUNCTION – LPRINT Z$ (CR,LF) 
2 TO DOS = в 


Z RETURN – O IF PRINTER READY 
255 IF NO RESPONSE 


2% TO DOS – PRINT DATA 

Z$ RETURN — NO CHANGE 

THIS FUNCTION WILL TRANSLATE 7% 

TO ASCII CODE AND SEND IT TO THE 
PRINTER I/F WITH CR AND LF CODES 
ADDED AT THE END OF THE Z$ DATA. 
"PRINTER READY" 1S TESTED FIRST. 


TRANSLATION DATA IS IN APPENDIX. 


— BBDOS FUNCTIONS FROM BASIC - 
FUNCTION — LPRINT 2% (NO CR,LF) 
2 TO DOS = 9 


Z RETURN - O IF PRINTER READY 
255 IF NO RESPONSE 


2% TO DOS - PRINT DATA 


Й 


Z$ RETURN — NO CHANGE 


THIS FUNCTION WILL TRANSLATE 7% 

TO ASCII CODE AND SEND IT TO THE 
PRINTER 1/F. NO CODES ARE ADDED. 
"PRINTER READY" 1S TESTED FIRST. 


TRANSLATION DATA 15 IN APPENDIX. 


— BBDOS FUNCTIONS FROM BASIC - 
FUNCTION — LPRINT Z$ AS ASCII 
Zo TO. DOS: = 10 


Z RETURN – O IF PRINTER READY 
255 IF NO RESPONSE 


2% TO DOS - PRINT DATA 

Z$ RETURN — NO CHANGE 

THIS FUNCTION WILL SEND 7% DATA 
DIRECTLY TO THE PRINTER AS ASCII 
CODE WITHOUT ANY TRANSLATION. NO 
ADDITIONAL CODES ARE APPENDED. 
EXAMPLE: IF Z$="3$",CR IS SENT. 


"PRINTER READY" IS TESTED FIRST. 


—- BBDOS FUNCTIONS FROM BASIC - 


FUNCTION — COPY SCREEN 


2 TO DOS = 12 


Z RETURN — O IF PRINTER READY 
255 IF NO RESPONSE 


2% TO DOS —. NOT APPLICABLE 


Z$ RETURN — NO CHANGE 


THIS FUNCTION SENDS A 24 LINE 
SCREEN COPY TO THE PRINTER 1/F. 


"PRINTER READY" 1S TESTED FIRST. 


— BBDOS FUNCTIONS FROM BASIC - 


FUNCTION — SELECT DRIVE A 


Z TO DOS = 14 


Z RETURN — NO CHANGE 


2% TO DOS – NOT APPLICABLE 


Z$ RETURN — NO CHANGE 


THIS FUNCTION SETS UP DRIVE A AS 
THE CURRENT DOS DRIVE. 


RETURNS IN SAME SPEED MODE. 


oa 


¬ BBDOS FUNCTIONS FROM BASIC - 
FUNCTION = SELECT DRIVE В 
2 TO DOS = 15 
Z RETURN — NO CHANGE 
2% TO DOS – NOT APPLICABLE 


Z$ RETURN - NO CHANGE 


THIS FUNCTION SETS UP DRIVE B AS 
THE CURRENT DOS DRIVE. 


RETURNS IN SAME SPEED MODE. 


— BBDOS FUNCTIONS FROM BASIC ~ 


FUNCTION ~ SAVE PROGRAM WITH 
FIRST BASIC LINE 
AS RESTART LINE 


2 TO DOS = 35 


Z RETURN — O IF WRITTEN OK 
255 IF NO DISK SPACE 


2% TO DOS - NEW DIRECTORY NAME 
(TRUNCATES OVER 15) 


Z$ RETURN - NO CHANGE 


THE "SAVED" PROGRAM WILL BE IN 
FAST MODE WITH THE DISPLAY FILE 
CLEAR AND Z=35. RETURN ALSO FAST 
MODE WITH DISPLAY FILE CLEAR,BUT 
WITH NEXT BASIC LINE RESTORED. 


—- BBDOS FUNCTIONS FROM BASIC - 
FUNCTION — SEARCH DIRECTORY 
2 TO DOS - SEE SEARCH KEY TABLE 


Z RETURN – O IF FOUND 
255 IF FAIL 


2% TO DOS - DIRECTORY NAME 
(TRUNCATES OVER 15) 


Z$ RETURN — FULL NAME IF FOUND 
NO CHANGE IF FAIL 


THIS FUNCTION HAS 30 DIFFERENT 
SEARCH KEY MODES-15 FOR PROGRAMS 
AND 15 FOR VARIABLES FILES. 


RETURNS IN FAST MODE. 


—- BBDOS FUNCTIONS FROM BASIC — 


MAXIMUM NAME LENGTH IN THE BBDOS 
DIRECTORY IS 15 CHARACTERS. THE 

SEARCH KEYS ARE DESIGNED TO LET 

YOU OPERATE WITH А NAME OF 2 TO 

14 CHARACTERS (LEFT FIELD) AND A 
NUMBER SCHEME OF 1 TO 13 DIGITS 

(RIGHT FIELD). HOWEVER, CONTENTS 
OF THE FIELDS CAN BE ANYTHING. 


DESIGN INTENT WAS TO ALLOW EASY 
HANDLING OF DATING OR SEQUENTIAL 
FILE NUMBERING FROM ANY PROGRAM. 


Z=11, Z=13 COMPARE FOR EQUALITY 
UP TO THE LENGTH OF 7% (MAX 15). 
THE OTHER KEYS FIRST COMPARE FOR 
EQUALITY ON ONLY THE LEFT FIELD, 
THEN COMPARE THE REMAINDER OF A 
QUALIFYING NAME FOR"GREATEST"OR 
"LEAST"TO BE FOUND ON THIS DISK. 


AD 


Z$ VS МАМЕ 


Z$ VS NAME 


SEARCH KEY TABLE 
Z TO DOS FOR PROGRAM SEARCHES 


SEARCH FOR 


EQUAL ON: 


FIRST 2 
FIRST 2 
FIRST 4 
FIRST 4 
FIRST 6 
FIRST 6 
FIRST 8 
FIRST 8 
FIRST 10 
FIRST 10 
FIRST 12 
FIRST 12 
FIRST 14 
FIRST 14 


THEN 
SEARCH: 
NOTHING 
NEXT 13 
NEXT 13 
NEXT 11 
NEXT 11 
NEXT 9 
NEXT 9 
NEXT 7 
NEXT 7 
NEXT 5 
NEXT 5 
NEXT 3 
NEXT 3 
NEXT 1 
NEXT 1 


SEARCH KEY TABLE 
Z TO DOS FOR VARIABLES SEARCHES 


SEARCH FOR 


EQUAL ON: 


FIRST 2 
FIRST 2 
FIRST 4 
FIRST 4 
FIRST 6 
FIRST 6 
FIRST 8 
FIRST 8 
FIRST 10 
FIRST 10 
FIRST 12 
FIRST 12 
FIRST 14 
FIRST 14 


THEN 
SEARCH: 
NOTHING 
NEXT 13 
NEXT 15 
NEXT 11 
NEXT 11 
NEXT 9 
NEXT 9 
NEXT 7 
NEXT 7 
NEXT 5 
NEXT 5 
NEXT 3 
NEXT 3 
NEXT 1 
NEXT 1 


FOR THE: 


GREATEST 
LEAST 
GREATEST 
LEAST 
GREATEST 
LEAST 
GREATEST 
LEAST 
GREATEST 
LEAST 
GREATEST 
LEAST 
GREATEST 
LEAST 


FOR THE: 


GREATEST 
LEAST 
GREATEST 
LEAST 
GREATEST 
LEAST 
GREATEST 
LEAST 
GREATEST 
LEAST 
GREATEST 
LEAST 
GREATEST 
LEAST 
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